Zeigt eine Meldung in einem Dialogfeld an und wartet darauf, da▀ der Benutzer auf eine SchaltflΣche klickt. Es wird dann einen Wert vom Typ Integer zurⁿckgegeben, der anzeigt, auf welche SchaltflΣche der Benutzer geklickt hat.
Syntax
MsgBox(prompt[, buttons] [, title] [, helpfile, context])
Die Syntax der MsgBox-Funktion verwendet die folgenden benannten Argumente:
| Teil | Beschreibung |
|---|---|
| prompt | Erforderlich. Ein Zeichenfolgenausdruck, der als Meldung im Dialogfeld erscheint. Die MaximallΣnge von prompt ist - je nach Breite der verwendeten Zeichen - etwa 1024 Zeichen. Wenn prompt aus mehreren Zeilen besteht, mⁿssen Sie die Zeilen mit einem Wagenrⁿcklaufzeichen (Chr(13)), einem Zeilenvorschubzeichen (Chr(10)) oder einer Kombination aus Wagenrⁿcklaufzeichen und Zeilenvorschubzeichen (Chr(13) & Chr(10)) trennen. |
| buttons | Optional. Ein numerischer Ausdruck, der der Summe der Werte entspricht, die Anzahl und Typ der anzuzeigenden SchaltflΣchen, die Art des zu verwendenden Symbols sowie die StandardschaltflΣche und die Bindung des Dialogfeldes angeben. Wenn Sie buttons nicht angeben, ist der Standardwert 0. |
| title | Optional. Ein Zeichenfolgenausdruck, der in der Titelleiste des Dialogfeldes angezeigt wird. Wenn Sie title nicht angeben, wird der Anwendungsname in der Titelleiste angezeigt. |
| helpfile | Ein Zeichenfolgenausdruck, der die Hilfedatei mit der kontextbezogenen Hilfe fⁿr das Dialogfeld angibt. Wenn Sie helpfile angeben, mⁿssen Sie auch context angeben. |
| context | Optional. Ein numerischer Ausdruck mit der Hilfekontextkennung, die der Autor der Hilfe fⁿr das entsprechende Hilfethema gegeben hat. Wenn Sie context angeben, mⁿssen Sie auch helpfile angeben. |
Einstellungen
Das Argument buttons hat die folgenden Einstellungen:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbOKOnly | 0 | Nur die SchaltflΣche OK anzeigen. |
| VbOKCancel | 1 | SchaltflΣchen OK und Abbrechen anzeigen. |
| VbAbortRetryIgnore | 2 | SchaltflΣchen Abbruch, Wiederholen und Ignorieren anzeigen. |
| VbYesNoCancel | 3 | SchaltflΣchen Ja, Nein und Abbrechen anzeigen. |
| VbYesNo | 4 | SchaltflΣchen Ja und Nein anzeigen. |
| VbRetryCancel | 5 | SchaltflΣchen Wiederholen und Abbrechen anzeigen. |
| VbCritical | 16 | Meldung mit Stop-Symbol anzeigen. |
| VbQuestion | 32 | Meldung mit Fragezeichen-Symbol anzeigen. |
| VbExclamation | 48 | Meldung mit Ausrufezeichen-Symbol anzeigen. |
| VbInformation | 64 | Meldung mit Info-Symbol anzeigen. |
| VbDefaultButton1 | 0 | Erste SchaltflΣche ist StandardschaltflΣche. |
| VbDefaultButton2 | 256 | Zweite SchaltflΣche ist StandardschaltflΣche. |
| VbDefaultButton3 | 512 | Dritte SchaltflΣche ist StandardschaltflΣche. |
| VbDefaultButton4 | 768 | Vierte SchaltflΣche ist StandardschaltflΣche. |
| VbApplicationModal | 0 | An die Anwendung gebunden. Der Benutzer mu▀ auf das Meldungsfeld reagieren, bevor er seine Arbeit mit der aktuellen Anwendung fortsetzen kann. |
| VbSystemModal | 4096 | An das System gebunden. Alle Anwendungen werden unterbrochen, bis der Benutzer auf das Meldungsfeld reagiert. |
| vbMsgBoxHelpButton | 16384 | Adds Help button to the message box |
| VbMsgBoxSetForeground | 65536 | Specifies the message box window as the foreground window |
| vbMsgBoxRight | 524288 | Text is right aligned |
| vbMsgBoxRtlReading | 1048576 | Specifies text should appear as right-to-left reading on Hebrew and Arabic systems |
Die erste Gruppe von Werten (0 - 5) beschreibt die Anzahl und den Typ der im Dialogfeld angezeigten SchaltflΣchen. Die zweite Gruppe (16, 32, 48, 64) beschreibt die Symbolart. Die dritte Gruppe (0, 256, 512) legt die StandardschaltflΣche fest. Die vierte Gruppe (0, 4096) legt fest, in welcher Form das Dialogfeld gebunden ist. Verwenden Sie beim Addieren der Zahlen zu einem Gesamtwert fⁿr das Argument buttons nur eine Zahl aus jeder Gruppe.
Anmerkung Diese Konstanten sind durch Visual Basic fⁿr Applikationen festgelegt. Daher k÷nnen die Namen an einer beliebigen Stelle im Code anstelle der tatsΣchlichen Werte verwendet werden.
Rⁿckgabewerte
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbOK | 1 | OK |
| vbCancel | 2 | Abbrechen |
| vbAbort | 3 | Abbruch |
| vbRetry | 4 | Wiederholen |
| vbIgnore | 5 | Ignorieren |
| vbYes | 6 | Ja |
| vbNo | 7 | Nein |
Bemerkungen
Wenn sowohl helpfile als auch context angeben werden, kann der Benutzer F1 (Windows) oder HILFE (Macintosh) drⁿcken, um das Hilfethema fⁿr context anzuzeigen. Einige Host-Anwendungen, zum Beispiel Microsoft Excel, fⁿgen dem Dialogfeld automatisch die SchaltflΣche Hilfe hinzu.
Wenn im Dialogfeld die SchaltflΣche Abbrechen angezeigt wird, hat das Drⁿcken von ESC dieselbe Wirkung wie das Klicken auf Abbrechen. Wird im Dialogfeld die SchaltflΣche Hilfe angezeigt, wird fⁿr das Dialogfeld eine kontextbezogene Hilfe zur Verfⁿgung gestellt. Ein Wert wird aber nur zurⁿckgegeben, wenn auf eine der anderen SchaltflΣchen geklickt wird.
Anmerkung Wenn Sie au▀er dem ersten benannten Argument weitere Argumente angeben m÷chten, mⁿssen Sie MsgBox in einem Ausdruck verwenden. Wenn Sie einige Argumente mit einer bestimmten Position nicht angeben m÷chten, mⁿssen Sie dennoch das entsprechende Komma als Trennzeichen angeben.